Improve documentation of new Xref options

* lisp/progmodes/xref.el (xref-auto-jump-to-first-definition)
(xref-auto-jump-to-first-xref): More accurate description in the
doc strings.

* doc/emacs/maintaining.texi (Looking Up Identifiers)
(Identifier Search, List Identifiers, Project File Commands): Fix
the documentation of 'xref-auto-jump-to-first-definition' and
'xref-auto-jump-to-first-xref' to be more accurate.

* etc/NEWS: More accurate wording of the entry about
'xref-auto-jump-to-first-definition' and
'xref-auto-jump-to-first-xref'.

Do not expand default method, user, host in remote file name completion

* lisp/net/tramp.el (tramp-completion-handle-file-name-all-completions):
Do not expand default method, user, host.  (Bug#50387)
(tramp-get-completion-methods): `partial-method' can be nil.

Fix display of tab-bar buttons

* src/xterm.c (x_draw_image_relief):
* src/w32term.c (w32_draw_image_relief): Fix calculation of relief
thickness for tab-bar buttons.

* lisp/tab-bar.el (tab-bar--load-buttons)
(tab-bar-history-mode): Fix the :margin specification for tab-bar
buttons.  (Bug#50424)

* test/lisp/vc/vc-tests.el (vc-test--version-diff): Git env tweak.

Support specifying just one command in project-switch-commands

* lisp/progmodes/project.el (project-switch-commands):
Describe the new possible type of value.
(project--switch-project-command):
New function, extract from project-switch-project.
(project-switch-project): If project-switch-commands's value is a
symbol, invoke that command without showing a menu.

Co-authored-by: Jiacai Liu <hello@liujiacai.net>

Small FAQ fixes

* doc/misc/efaq.texi (Colors on a TTY): Remove reference to
ancient Emacs version 22.
(Finding Emacs on the Internet): Use more current terminology.

Remove Emacs FAQ maintainer

* doc/misc/efaq.texi: Remove maintainer Romain Francoise after private
communication.

* etc/NEWS: Some further re-organization.

* etc/NEWS: Clarify entry about the "*Completions*" buffer.

Add possibility to override the default highlighting

* lisp/progmodes/bug-reference.el (bug-reference-fontify): Highlight
99th group if it exists.
(bug-reference-bug-regexp): Document that regexp group 99 can be used
to override the default behavior of highlighting the complete match.
(bug-reference--run-auto-setup): Use run-hook-with-args-until-success
instead of throw/catch.

; * etc/NEWS: revert a change that changed the meaning slightly

Normalise nested `progn` forms in byte-code optimiser

* lisp/emacs-lisp/byte-opt.el (byte-optimize-body): Flatten body.
This simplifies the source tree and reduces the number of different
cases that other optimisations need to take into account.

More robust optimisation of `ignore`

Treat `ignore` as any other function during source-level optimisation,
to avoid having its warning-suppression effects cancelled by repeated
passes.  Instead, define a custom code generation function.

* lisp/emacs-lisp/byte-opt.el (byte-optimize-form-code-walker):
Don't treat `ignore' specially here.
(side-effect-free-fns): Don't mark `ignore` as side-effect-free
or error-free (although it is), since that would allow the optimiser
to elide calls.
* lisp/emacs-lisp/bytecomp.el (ignore, byte-compile-ignore):
Define and register a code-gen function.

Optimise `member` and `assoc` (etc) with constant empty list

* lisp/emacs-lisp/byte-opt.el
(byte-optimize-assq): New.
(byte-optimize-member, byte-optimize-assoc, byte-optimize-memq):
When the list argument is constant nil, the result is always nil.
* test/lisp/emacs-lisp/bytecomp-tests.el (bytecomp-tests--test-cases):
Add test cases.

Fixup dired-do-find-regexp-and-replace

* lisp/dired-aux.el (dired-do-find-regexp-and-replace):
Disregard the customized value of xref-auto-jump-to-first-xref
(it breaks the xref-query-replace-in-results invocation).

* lisp/progmodes/xref.el (xref-auto-jump-to-first-xref):
Mention the caveat for users or xref distributed through ELPA.

Revert an accidential change in etc/NEWS

; Fix typos in etc/NEWS

Make calc-grab-region work with rectangular selects

* lisp/calc/calc.el (calc-grab-region): Heed `rectangle-mark-mode'
(bug#50403).

Restore the debugging window size more reliably

* lisp/emacs-lisp/debug.el (debug): Restore the debugging window
size more reliably (bug#12921).

Add a tooltip to the comint-mode mode line format

* lisp/comint.el (comint-mode): Add a tooltip to say what the :run
bit means (bug#13776).

Improve the info-mode mode line

* lisp/info.el (Info-set-mode-line): Add a help echo to help
explain what the thing in parentheses is (bug#13776).

; * lisp/tab-bar.el (toggle-frame-tab-bar, tab-bar-new-tab-to): Doc fix.

Merge branch 'master' of git.savannah.gnu.org:/srv/git/emacs

Merge branch 'master' of git.savannah.gnu.org:/srv/git/emacs

Simplify `image-dired-dired-file-marked-p'

* lisp/image-dired.el (image-dired-dired-file-marked-p): Use
`dired-re-mark' instead of open-coding the opposite regexp (bug#14925).

; * etc/NEWS: Rearrange and fix wording of some entries.

Improve the gnus-group-default-list-level doc string

* lisp/gnus/gnus-group.el (gnus-group-default-list-level): Improve
doc string.

Reset gnus-group-use-permanent-levels when Gnus restarts

* lisp/gnus/gnus-start.el (gnus-clear-system): Reset
`gnus-group-use-permanent-levels' upon Gnus restart (bug#50416).

Make `gnus-group-use-permanent-levels' work better

* lisp/gnus/gnus-group.el (gnus-group-default-level): Removed implicit
setting of gnus-group-use-permanent-levels.
(gnus-group-list-groups): Set gnus-group-use-permanent-levels
explicitly.
(gnus-group-get-new-news): Set gnus-group-use-permanent-levels
explicitly (bug#50417).
(gnus-group-get-new-news): When the user has given a numeric
prefix, use that as the list level.

; * etc/NEWS: Restore entry that had been inadvertently deleted.

* etc/NEWS: Reorder "Isearch and Replace" items

* doc/emacs/maintaining.texi (Xref Commands): Fix indexing.

* etc/NEWS: Improve file organization.

Improve documentation of save-place-abbreviate-file-names

* lisp/saveplace.el (save-place-abbreviate-file-names): Document why
you might want to enable this option.

* etc/NEWS: Don't mention a fixed bug.

; * test/lisp/newcomment-tests.el: Fix copyright year.

project--files-in-directory: Fix handling of ignores

* lisp/progmodes/project.el (project--files-in-directory):
Pass "." as the DIR argument to 'find' because otherwise the ignore
expression can match the project root directory name, which we don't
want to happen (bug#50240).  Fixup the resulting file names at the end
with concatenation.
Originally I thought it could lead to worse performance, but the
results show equal or slightly better timings.

* lisp/progmodes/xref.el (xref-matches-in-directory):
Apply a similar fix.
(xref--find-ignores-arguments): Use file-name-as-directory, so
that when passed "." replace-match still had the expected effect.

* test/lisp/progmodes/project-tests.el (project-ignores-bug-50240):
New test.

* test/lisp/progmodes/xref-tests.el
(xref-matches-in-directory-filters-with-ignores): New test.

Try to fix vc-test-git06-version-diff on Hydra

* test/lisp/vc/vc-tests.el (vc-test--version-diff):
Fix Git backend when running in clean environment.
(vc-test-git06-version-diff): Unskip on Hydra.

* test/lisp/vc/vc-tests.el (vc-test-git06-version-diff): Skip on hydra.

* lisp/progmodes/xref.el: Bump the version again.

; * lisp/indent.el (tab-first-completion): Fix :version tag.

Autoload cl-struct-slot-info

* lisp/emacs-lisp/cl-macs.el (cl-struct-slot-info): Autoload
(bug#50301).

* test/lisp/emacs-lisp/memory-report-tests.el: Don't require cl-macs.

; * etc/NEWS: Fix a recent change.

Improve the documentation around the read-key/minibuffer prompting

* lisp/subr.el (read-char-choice-use-read-key): Explain the
difference.
(read-char-choice): Mention the variables.
(y-or-n-p-use-read-key): Explain the difference.
(y-or-n-p): Mention the variable (bug#50390).

Clarify completion-list-mode NEWS entry

* etc/NEWS: Clarify completion-list-mode entry (bug#50394).

; * doc/emacs/maintaining.texi (Looking Up Identifiers): Fix last change.

* lisp/progmodes/xref.el: Fix defcustoms (bug#50067)

* lisp/progmodes/xref.el (xref-auto-jump-to-first-definition)
(xref-auto-jump-to-first-xref, xref-search-program): Fix defcustoms.

Improve documentation of new Xref options

* doc/emacs/maintaining.texi (Looking Up Identifiers):
* etc/NEWS: Document the new Xref user options.  Move a lost
Xref-related entry to the rest of them.

Fixes for 'python-shell-send-string' and 'python-shell-send-file'

* lisp/progmodes/python.el (python-shell-send-string): use a temporary
file for sufficiently long strings.
(python-shell-send-file, python-shell-eval-file-setup-code): Avoid
showing "plumbing code" in the traceback (bug#32042).

Fix error handling in 'ispell-init-process'

* lisp/textmodes/ispell.el (ispell-init-process): When Ispell
initialization reports an error, call 'ispell-accept-output' only
if the Ispell process is still alive.  (Bug#50370)

Copyright-paperwork-exempt: yes

Cleanup tramp-tests.el

* test/lisp/net/tramp-tests.el
(tramp--test--deftest-direct-async-process): Fix macro declaration.
(tramp-test29-start-file-process, tramp-test30-make-process):
Do not run connection type test for direct async processes.

* test/lisp/vc/vc-tests.el (vc-test-sccs06-version-diff): Fix it.

Belated fix

* lisp/progmodes/xref.el: (xref--show-xref-buffer):
Fix support for xref-auto-jump-to-first-xref.

* lisp/progmodes/xref.el: Bump version.

Xref: automatic jumping to the first definition or reference

* lisp/progmodes/xref.el (xref-auto-jump-to-first-definition)
(xref-auto-jump-to-first-xref): New user options.
Discussed in bug#50067.
(xref--show-xrefs, xref--show-defs): Use them here.
(xref--auto-jump-first): New function, handles different values.
(xref-show-definitions-buffer)
(xref-show-definitions-buffer-at-bottom): Use it.

Fix test on machines with Bzr not set up

* test/lisp/vc/vc-tests.el (vc-test--version-diff):
Add EMAIL= to the environment to avoid potential failure.

Add tests for vc-version-diff

* test/lisp/vc/vc-tests.el (vc-test--version-diff):
New function.
(vc-test-%s06-version-diff): New family of tests.

Rename xref-select-and-{goto,show}-xref

* lisp/progmodes/xref.el (xref-select-and-show-xref):
Rename from xref-select-and-goto-xref (bug#35376).
Update all references.

Avoid segfault in command-modes

* src/data.c (Fcommand_modes): Check that bytecode object is
interactive before accessing its interactive spec to avoid
segfaulting (bug#50376).

; * etc/NEWS: Fix copyright year; file recreated in 2019 for 28.1.

; * etc/NEWS: Fix markup in recent example.

* lisp/emacs-lisp/timer.el (timer-create): Don't inline it

Improve documentation of line truncation and wrapping

* doc/emacs/display.texi (Line Truncation, Visual Line Mode):
* doc/lispref/display.texi (Truncation): Document that turning on
line truncation disables wrapping, and vice versa.

* src/buffer.c (syms_of_buffer) <truncate-lines>:
* src/xdisp.c (syms_of_xdisp) <truncate-partial-width-windows>:
Warn against turning on when 'visual-line-mode' is in effect.
* lisp/simple.el (visual-line-mode): Document that this mode
disables line truncation.  (Bug#29664)

Allow killing the diff buffer after `C-x v u'

* doc/emacs/maintaining.texi (VC Undo): Document this.
* lisp/vc/vc.el (vc-revert-show-diff): Allow a `kill' value.
(vc-revert): Use it (bug#16902).

Improve error message in ielm on printing errors

* lisp/ielm.el (ielm-eval-input): Don't claim that there's a bug
on pp -- it may just be something that nests too far (bug#18012).

Add a customization group link from whitespace-mode

* lisp/whitespace.el (whitespace-mode): Add a link to the
whitespace customization group to see the faces (bug#18296).

Add support for customization group hyperlinks in doc strings

* lisp/help-mode.el (help-customization-group): New button.
(help-xref-customization-group-regexp): New const.
(help-make-xrefs): Use them to allow making customization group
buttons.

Make multi-frame `M-x calendar' setup work when `pop-up-frames'

* lisp/calendar/calendar.el (calendar): Make the calendar frame
setup work when pop-up-frames is non-nil (bug#19256).

Tweak hi-lock-mode doc string

* lisp/hi-lock.el (hi-lock-mode): Tweak the doc string so that
running hi-lock-mode in a *Help* buffer showing this help text
won't issue an error (bug#20977).

Make `M-x term' offer completion

* lisp/term.el (term): Have completion in the prompt (bug#21296).

Add diary-offset to diary-lib.el

* doc/emacs/calendar.texi: Document the change.
* lisp/calendar/diary-lib.el (diary-offset):
* test/lisp/calendar/icalendar-tests.el: Add a test (bug#50195).

* etc/DISTRIB: Refer to gnu.org instead of the deleted file etc/GNU.

Merge from origin/emacs-27

0aa0410372 (origin/emacs-27, emacs-27) Fix "Finder" description for m...

Change Python eval to send directly instead of using temporary files

* lisp/progmodes/python.el (python-shell-eval-setup-code): New
const for setting up eval (bug#49822).
(python-shell--encode-string): New function.
(python-shell-send-string): Use it to send commands directly
instead of writing to a temporary file.
(python-shell-send-string-no-output): Adjust sending.
(python-shell-send-file): Ditto.

Update to CSS Flexible Box Layout Module Level 2

* css-mode.el (css-property-alist): Update link.

Update to CSS Containment Module Level 2

* css-mode.el (css-property-alist): Update contain, and add
content-visibility.

Update to CSS Grid Layout Module Level 2

* css-mode.el (css-property-alist): Update to the newer spec, and add
the subgrid keywords

Clean up css-property-alist for alignment

* css-mode.el (css-property-alist, css-value-class-alist): Provide new
position related entries for use in css-property-alist.  Make sure
that property-alist reflect the spec:
https://www.w3.org/TR/css-align-3/#property-index

Fix `describe-function' for autoloaded adviced functions

* lisp/emacs-lisp/nadvice.el (advice--make-single-doc): Factor
out.
(advice--make-docstring): From here (bug#23523).  Also include
advices for autoloads.

Allow gud-mi to edit two executables with the same name

* lisp/progmodes/gud.el (gud-common-init): Allow editing two
executables with the same name (bug#22772).

; Fix typos

Make recent timer changes more backwards-compatible

* lisp/emacs-lisp/timer.el (timerp, timer-event-handler): Make
backwards-compatible with old .elc files that have their own
versions of `timer-create'd structures.

Fix message in previous toggle-truncate-lines change

* lisp/simple.el (toggle-truncate-lines): Fix message in previous
change.

Allow not putting pasted text onto the kill ring under xterm

* lisp/term/xterm.el (xterm-paste): Don't put pasted text onto the
kill ring (bug#28868).
(xterm-store-paste-on-kill-ring): New user option.

* etc/NEWS: Announce recent change in 'toggle-truncate-lines'.

Sync latest SKK-JISYO.L

* leim/SKK-DIC/SKK-JISYO.L: Sync to current upstream version.

Update publicsuffix.txt from upstream

* etc/publicsuffix.txt: Update from
https://publicsuffix.org/list/public_suffix_list.dat
dated 2021-09-02 22:13:03 UTC.

Make toggle-truncate-lines disable visual-line-mode

* lisp/simple.el (toggle-truncate-lines): Disable
`visual-line-mode' (bug#29664).

Avoid cl-lib alias for cadadr and friends

* lisp/edmacro.el (edmacro-fix-menu-commands):
* lisp/frameset.el (frameset-move-onscreen):
* lisp/htmlfontify.el (hfy-face-at, hfy-merge-adjacent-spans)
(hfy-mark-tag-names):
* lisp/mail/footnote.el (footnote--make-hole)
(footnote-back-to-message):
* lisp/net/eudc.el (eudc-get-email, eudc-get-phone):
* lisp/net/rcirc.el (rcirc-make-trees, rcirc-handler-333)
(rcirc-authenticate):
* lisp/play/5x5.el (5x5-draw-grid, 5x5-solver):
* lisp/play/decipher.el (decipher-insert-frequency-counts):
* lisp/ses.el (ses-relocate-range):
* test/lisp/emacs-lisp/edebug-tests.el (edebug-tests-step-into-macro-error)
(edebug-tests-error-stepping-into-subr): Avoid using cl-lib aliases
for cadadr and friends that now reside in subr.el.

Move cl-lib tests for caaXr to subr-tests.el

* test/lisp/emacs-lisp/cl-lib-tests.el (cl-test-caaar)
(cl-test-caadr): Move tests using a cl-lib alias from here...
* test/lisp/subr-tests.el (subr-test-caaar, subr-test-caadr): ...to
here.  The functions under test are in subr.el.

Add CSS Box Alignment Module Level 3 to css-mode

* lisp/textmodes/css-mode.el (css-property-alist): Consolidate
`align-{contents, items, self}', as well as the corresponding
values for `justify-{contents, items, self}' and `place-{contents,
items, self}'.  Values extracted from the flex part and into its
own block (bug#50345).

Add selection to css-pseudo-element-ids

* lisp/textmodes/css-mode.el (css-pseudo-element-ids): Add
selection as an element id (bug#50345).

Fix `revert-buffer' message in `find-file-select'

* lisp/files.el (find-file-noselect): Refer to revert-buffer-quick
here since we're in a file-based buffer.

Fix memory-report test failure

* test/lisp/emacs-lisp/memory-report-tests.el: Fix test build failure.

Fix recently broken vc-delete-file with Git

* lisp/vc/vc-git.el (vc-git-delete-file):
Treat FILE as string, not list (bug#50334).

More fixes for recently added vc-rename test

* test/lisp/vc/vc-tests.el (vc-test-cvs05-rename-file): Skip.
(vc-test-sccs05-rename-file): Treat like RCS.

Support forges by type rather than by host

Formerly, bug-reference-setup-from-vc-alist basically had one entry
per host (like gitlab.com).  Restructure so that it's easy to add new
hosts being just an instance of some type of forge such as SourceHut,
Gitea, or GitLab.

While we're at it, add support for gitea.com, salsa.debian.org, and
framagit.org, the latter two being GitLab instances.

* lisp/progmodes/bug-reference.el (bug-reference-gitea-instances)
(bug-reference-gitlab-instances,bug-reference-sourcehut-instances):
New variables listing online instances of those forges.
(bug-reference--setup-from-vc-alist): New function (and variable for
caching) using the former three new variables to generate suitable VC
auto-setup alist.
(bug-reference-try-setup-from-vc): Use both
bug-reference-setup-from-vc-alist and
bug-reference--setup-from-vc-alist.

* lisp/abbrev.el: Improve docstrings of inverse commands (bug#50303)

* lisp/abbrev.el (add-mode-abbrev, add-global-abbrev)
(inverse-add-mode-abbrev, inverse-add-global-abbrev):
Add interlinking to opposite commands in docstrings.

; * doc/emacs/dired.texi (Operating on Files): Fix last change.

Fix expansion of non-ASCII $HOME

* src/fileio.c (Fexpand_file_name): Make the file name multibyte
if the value of $HOME is multibyte.  (Bug#50266)